Annotation Lists and Annotations

Basics

"@type": "sc:AnnotationList"

Annotations provided as a list of Resources.

Each Annotation follows the Open Annotation model.

Annotation

{

  "@context": "http://iiif.io/api/presentation/2/context.json",

  "@id": "http://example.org/iiif/book1/annotation/p1",

  "@type": "oa:Annotation",

  "motivation": "sc:painting",

  "resource":{

    "@type": "cnt:ContentAsText",

    "chars": "Here starts book one...",

    "format": "text/plain",

    "language": "en"

  },

  "on": "http://example.org/iiif/book1/canvas/p1#xywh=100,150,500,25"

}

Key properties:

@id - may or may not be dereferenceable
"@type": "oa:Annotation"

Motivations:

Part of the Open Annotation specification, also the W3c Web Annotation Model:

Term Are
assessing User intends to assess the target resource in some way, rather than simply make a comment about it. For example to write a review or assessment of a book, assess the quality of a dataset, or provide an assessment of a student's work.
bookmarking User intends to create a bookmark to the Target or part thereof. For example an Annotation that bookmarks the point in a text where the reader finished reading.
classifying User intends to classify the Target as something. For example to classify an image as a portrait.
describing User intends to describe the Target, as opposed to (for example) a comment about it. For example describing the above PDF's contents, rather than commenting on their accuracy.
editing User intends to request a change or edit to the Target resource. For example an Annotation that requests a typo to be corrected.
highlighting User intends to highlight the Target resource or segment of it. For example to draw attention to the selected text that the annotator disagrees with.
identifying User intends to assign an identity to the Target. For example to associate the IRI that identifies a city with a mention of the city in a web page.
linking User intends to link to a resource related to the Target.
moderating User intends to assign some value or quality to the Target. For example annotating an Annotation to moderate it up in a trust network or threaded discussion.
questioning User intends to ask a question about the Target. For example to ask for assistance with a particular section of text, or question its veracity.
replying User intends to reply to a previous statement, either an Annotation or another resource. For example providing the assistance requested in the above.
tagging User intends to associate a tag with the Target.

Resource

@type
format
language

The type, format, language, and motivation are all intended to provide a consuming client application with information about how it should render those annotations in the viewing experience.